﻿<!DOCTYPE html>
<html>
	<head>
		<title>LINEST Function</title>
		<meta charset="utf-8" />
		<meta name="description" content="" />
		<link type="text/css" rel="stylesheet" href="../../../../../../common/main/resources/help/editor.css" />
		<link type = "text/css" rel = "stylesheet" href = "../../images/sprite.css" />
        <script type="text/javascript" src="../callback.js"></script>
        <script type="text/javascript" src="../search/js/page-search.js"></script>
	</head>
	<body>
		<div class="mainpart">
            <div class="search-field">
                <input id="search" class="searchBar" placeholder="Search" type="text" onkeypress="doSearch(event)">
            </div>
			<h1>LINEST Function</h1>
			<p>The <b>LINEST</b> function is one of the <a href="../UsageInstructions/InsertFunction.htm#statistical" onclick="onhyperlinkclick(this)">statistical functions</a>. It is used to calculate the statistics for a line by using the least squares method to calculate a straight line that best fits your data, and then returns an array that describes the line; because this function returns an array of values, it must be entered as an array formula.</p>
			<h3>Syntax</h3> 
			<p><b><em>LINEST(known_y's, [known_x's], [const], [stats])</em></b></p> 
			<p>The <b>LINEST</b> function has the following argument:</p>
            <table style="width: 40%">
                <tr>
                    <th style="background-color: #f4f4f4" width="150ch"><b>Argument</b></th>
                    <th style="background-color: #f4f4f4"><b>Description</b></th>
                </tr>
                <tr>
                    <td><b><em>known_y's</em></b></td>
                    <td>A known range of <em>y</em> values in the equation <em>y = mx + b</em>. This is the required argument.</td>
                </tr>
				<tr>
                    <td><b><em>known_x's</em></b></td>
                    <td>A known range of <em>x</em> values in the equation <em>y = mx + b</em>. This is an optional argument. If it is omitted, <em>known_x's</em> is assumed to be the array <em>{1,2,3,...}</em> with the same number of values as <em>known_y's</em>.</td>
                </tr>
				<tr>
                    <td><b><em>const</em></b></td>
                    <td>A logical value that specifies if you want to set <em>b</em> equal to <em>0</em>. This is an optional argument. If it is set to <em>TRUE</em> or omitted, <em>b</em> is calculated normally. If it is set to <em>FALSE</em>, <em>b</em> is set equal to <em>0</em>.</td>
                </tr>
				<tr>
                    <td><b><em>stats</em></b></td>
                    <td>A logical value that specifies if you want to return additional regression statistics. This is an optional argument. If it is set to <em>TRUE</em>, the function returns the additional regression statistics. If it is set to <em>FALSE</em> or omitted, the function does not return the additional regression statistics.</td>
                </tr>
            </table>
			
			<h3>Notes</h3>
            <p>Please note that this is an array formula. To learn more, please read the <a href="../UsageInstructions/InsertArrayFormulas.htm" onclick="onhyperlinkclick(this)">Insert array formulas</a> article.</p>
            <p><a href="../UsageInstructions/InsertFunction.htm#applyfunction" onclick="onhyperlinkclick(this)">How to apply</a> the <b>LINEST</b> function.</p>
			
            <h3>Examples</h3>
            <p>The first value of the resulting array will be displayed in the selected cell.</p>
			<p><img alt="LINEST Function" src="../images/linest.png" /></p>
		</div>
	</body>
</html>